SetDialogItem

SetDialogItem
Header:	Dialogs.h		Carbon status:	Supported

Sets or changes information for a dialog item.

void SetDialogItem (
    DialogPtr theDialog, 
    DialogItemIndex itemNo, 
    DialogItemType itemType, 
    Handle item, 
    const Rect *box
);

theDialog: A pointer to the dialog box containing the dialog item.
itemNo: The position of the item in the dialog box’s item list resource; use FindDialogItem to determine this value.
itemType: A short value. Pass an item type constant identifying the dialog item specified in the itemNo parameter. When an embedding hierarchy is established, only the kItemDisableBit item type constant is honored.
item: Either a handle to the dialog item specified in the itemNo parameter or, for a custom dialog item, a pointer (coerced to a handle) to an application-defined item drawing function. When an embedding hierarchy is established, the item parameter is ignored unless you pass a universal procedure pointer to an application-defined item draw function.
box: A pointer to the display rectangle (in local coordinates) for the item specified in the itemNo parameter. If you set the control rectangle on an item when an embedding hierarchy is present, SetDialogItem will move and resize the item appropriately for you, on return.

DISCUSSION

The SetDialogItem function sets the item specified by the itemNo parameter for the specified dialog box. If an embedding hierarchy exists, however, you cannot change the type or handle of an item, although application-defined item drawing functions can still be set.

VERSION NOTES

This function was changed with Appearance Manager 1.0 to work with embedding hierarchies.

AVAILABILITY

Supported in Carbon. Available in CarbonLib 1.0 and later when InterfaceLib 7.1 or later is installed. Exported by CarbonLib 1.0 and later and by InterfaceLib 7.1 and later.